home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic 4 Power Pack / Visual_Basic4_Power_Pack.bin / vb4files / vbmax3d / read me.txt < prev    next >
Encoding:
Text File  |  1996-11-20  |  11.5 KB  |  458 lines
  1. VBMax 3D Effects DLL
  2.  
  3. Copyright 1995-1996 Mike Stanley.  All Rights Reserved
  4.  
  5.                     VBMax - Visual Basic to the Max
  6.  
  7.  
  8. TABLE OF CONTENTS
  9.  
  10.    Description
  11.    Version Information
  12.       Version 1.2
  13.       Version 1.1
  14.    Registration
  15.    Important-Use at Your Own Risk!
  16.    Installation
  17.    Frequently Asked Questions
  18.    Technical Support
  19.    Gronked Files
  20.    Packing List
  21.    How to use the DLL
  22.    Methods Summary
  23.    Properties Summary
  24.  
  25.  
  26.  
  27. DESCRIPTION
  28.  
  29. Add the 3D effects that Microsoft forgot to your VB 4.0 applications.
  30.  
  31. Written entirely in VB 4.0, VBMax3D.dll is a fully functional in-process OLE
  32. server that provides you with a variety of 3D effects without the overhead 
  33. of third-party controls.   
  34.  
  35. VBMax3D.dll is Windows 95 color-scheme aware and contains methods and 
  36. properties for creating panels, borders, frames, lines, drop shadows, status
  37. bars, progress meters and many different types of text effects. 
  38.  
  39. When you register, you get the complete, fully-commented source code so you 
  40. can see how it works and modify it any way you want to suit your own needs.
  41.  
  42. Shareware: $5.  
  43.  
  44. The archive file is freely distributable.
  45.  
  46.  
  47.  
  48. VERSION INFORMATION
  49.  
  50. Version 1.2
  51. Updated this documentation to include a Frequently Asked Questions 
  52. section.
  53.  
  54. Version 1.1
  55. Changed the demo program by replacing the Windows common slider control
  56. with scroll bars because users of VB Standard Edition did not have 
  57. COMCTL32.OCX.
  58.  
  59.  
  60.  
  61. REGISTRATION
  62.  
  63. This is a shareware utility which you can register for US $5 per copy. 
  64. Send payment to:
  65.  
  66.    Mike Stanley
  67.    25 Lansdowne Street
  68.    Manchester
  69.    NH 03103
  70.    USA
  71.  
  72. In return, I will give you a registration ID and an encryption key 
  73. which will allow you to unlock the source code from the file 
  74. 'VBMax3D Source Code.grk'.
  75.  
  76. *Don't forget to include your Internet e-mail address.*
  77.  
  78. Better still, also send me an e-mail to let me know that your 
  79. registration is on the way.  
  80.  
  81. Any future updates to the software will use the same encryption key, so 
  82. you can always get them at no additional cost.
  83.  
  84. If you don't have an e-mail address, you can receive the registration 
  85. ID and encryption key via snail-mail by sending me a postage-paid 
  86. self-addressed envelope.
  87.  
  88.  
  89.  
  90. IMPORTANT-USE AT YOUR OWN RISK!
  91.  
  92. While every effort has been made to ensure a reliable, high-quality 
  93. product, you should note that this software is provided 'as is' without 
  94. any kind of warranty whatsoever, neither explicit nor implied.
  95.  
  96. In order to use this software, you must agree 100% that I will not be 
  97. held liable in any way, shape or form (not even a little bit) for 
  98. anything untoward that befalls anyone or anything, either directly or 
  99. indirectly, as a result of using this software no matter how calamitous, 
  100. disastrous or inauspicious the occasion may be.
  101.  
  102. Your use of this software constitutes acceptance of these terms.
  103.  
  104.  
  105.  
  106. INSTALLATION
  107.  
  108. Copy the files to a folder of your choice and edit Reg.bat so that it 
  109. contains the correct path for the regsvr32.exe program that comes with 
  110. VB 4.0.  Please note that regsvr32.exe is not copied to your hard-drive 
  111. automatically when you install VB - you can find it in the Tools\Pss 
  112. folder on your VB CD.
  113.  
  114. Run the edited Reg.bat which will update the Windows registry so that 
  115. it knows about VBMax3D.dll.
  116.  
  117. Go into VB, load the demo program and run it.
  118.  
  119. If you want to use the DLL in your own programs, you have to add a 
  120. reference to it as follows:
  121.  
  122. From VB, select Tools from the menu.
  123.  
  124. Then select References.
  125.  
  126. Locate VBMax 3D Effects in the list and click the check box so that an 
  127. X appears in it.  Click OK.
  128.  
  129. The OLE server is now visible in the Object Browser.
  130.  
  131.  
  132.  
  133. FREQUENTLY ASKED QUESTIONS
  134.  
  135. Q.  I try to run your demo program but it keeps telling me that OLE 
  136.     cannot create the object.  Why?
  137. A.  You have not registered VBMax3D.dll with Windows.  Please refer to 
  138.     the installation instructions above.
  139.  
  140. Q.  I have searched my hard-drive but cannot find regsvr32.exe - what's
  141.     the scoop?
  142. A.  Regsvr32.exe is not copied to your hard-drive automatically when 
  143.     you install VB - you can find it in the Tools\Pss folder on your 
  144.     VB CD.
  145.  
  146. Q.  Why don't you just create a regular installation program?
  147. A.  One thing I don't like about VB 4 is the amount of extra baggage 
  148.     that must be included with the installation of even the simplest 
  149.     programs-this translates to long download times from online services.  
  150.     
  151.     Seeing as VBMax3D.dll is meant for programmers who already have all 
  152.     the necessary software installed on their computers, I decided that 
  153.     manually installing the DLL was a fair tradeoff to racking up your    
  154.     online connect time.
  155.  
  156.  
  157.  
  158. TECHNICAL SUPPORT
  159.  
  160. Technical support is available via e-mail.  Please send questions, 
  161. comments, criticisms, etc. to 74632.2227@compuserve.com.
  162.  
  163.  
  164.  
  165. GRONKED FILES
  166.  
  167. These are encrypted files, created using the VBMax Gronk Meister, that 
  168. contain one or more other files.  In this case, the file 
  169. 'VBMax3D Source Code.grk' contains the complete, commented VB 4.0 
  170. source code for VBMax3D.dll.
  171.  
  172. The source files may be extracted using the included VBMax Degronker 
  173. utility.  Before you can do that, however, you need to know the 
  174. encryption key.  This key will be given to you when you register 
  175. VBMax3D.dll.
  176.  
  177.  
  178.  
  179. PACKING LIST
  180.  
  181. Read Me.rtf/txt            -    The document you are reading.
  182. 3Ddemo.vbp (and related files)    -    Source code for demo program 
  183.                     showing the DLL in action.
  184. Reg.bat                -    Registers the DLL with Windows 
  185.                     (you have to edit the path).
  186. Unreg.bat            -    Unregisters the DLL with Windows 
  187.                     (you have to edit the path).
  188. VBMax3D Source Code.grk        -    Source code for the DLL in 
  189.                     gronked format.
  190. Degronker.exe            -    Utility to extract the source 
  191.                     code from the gronked file.
  192.  
  193.  
  194.  
  195. HOW TO USE THE DLL
  196.  
  197. When you include a reference to VBMax3D.dll in VB as described earlier, 
  198. you will have access to a class called cls3D.  When you select this 
  199. class using the Object Browser, you will see the methods and 
  200. properties available to you.  You can see a brief description of what 
  201. each one does by clicking on them.
  202.  
  203. In your application, you can create one or more objects from this class 
  204. module.  How many you choose depends on how many effects you want and 
  205. whether or not they share the same attributes.  For example, if you set 
  206. the style property to gnRAISED, all effects that use this property will 
  207. use the same style.
  208.  
  209. If you want to use different styles you have two options:
  210.  
  211.     1.    Change the style property each time you use it.
  212.     2.    Create different objects with different styles.
  213.  
  214. It's your call-yer pays yer money and yer takes yer choice.  Multiple 
  215. objects all use the same code but keep their own copy of the variables.
  216.  
  217. Objects are created from this class by using code like this:
  218.  
  219.     Dim mo3D As New cls3D.
  220.  
  221. You create 3D effects by drawing regular 2D controls on a form and then 
  222. passing them to methods in the object created by cls3D.  
  223.  
  224. These methods then create the desired 3D effect by drawing on the form 
  225. at the location of the 2D control.  The 2D controls act as 
  226. place-holders for the resulting 3D effect and allow you to see what you 
  227. are doing as you design your form.
  228.  
  229. You can get a good idea of how the DLL works by examining the source 
  230. code for the demo program.  More detailed information is contained 
  231. within the DLL source code.
  232.  
  233.  
  234.  
  235.  
  236. METHODS SUMMARY
  237.  
  238. Object.Border Control
  239.  
  240. Draws a border around a control.
  241.  
  242. Control:    Control around which border is to be drawn.
  243.  
  244. Example:    mo3D.Border Text1
  245.  
  246.  
  247.  
  248. Object.Caption Control [, FontSwitch]
  249.  
  250. Draws text using a variety of 3D effects.
  251.  
  252. Control:    Label control used as place-holder and source for text.
  253.  
  254. FontSwitch:    Optional.  If set, uses the font attributes of the 
  255.         Label control
  256. Settings:    gnUSE_CONTROL_FONT
  257.  
  258. Example 1:    mo3D.Caption Label1
  259. Example 2:    mo3D.Caption Label1, gnUSE_CONTROL_FONT
  260.  
  261.  
  262.  
  263. Object.DropShadow Control
  264.  
  265. Draws a drop-shadow behind a control.
  266.  
  267. Control:    The control behind which the shadow is to be drawn.
  268.  
  269. Example:    mo3D.DropShadow Text1
  270.  
  271.  
  272.  
  273. Object.FormBorder Form
  274.  
  275. Draws a border around the inside edge of a form.
  276.  
  277. Form:        The form on which to draw the border.
  278.  
  279. Example:    mo3D.FormBorder Me
  280.  
  281.  
  282.  
  283. Object.Frame Control, Caption
  284.  
  285. Draws a frame around a control.
  286.  
  287. Control:    Control around which frame is to be drawn.
  288.  
  289. Caption:    Frame caption.
  290.  
  291. Example:    mo3D.Frame picFrameColor, "Color"
  292.  
  293.  
  294.  
  295. Object.Line3D Control
  296.  
  297. Draws a 3D line.
  298.  
  299. Control:    Line control used as a place-holder.
  300.  
  301. Example:    mo3D.Line3D Line1
  302.  
  303.  
  304.  
  305. Object.Panel Control
  306.  
  307. Converts a control to a panel.
  308.  
  309. Control:    Control used as place-holder for panel.
  310.  
  311. Example:    mo3D.Panel Shape1
  312.  
  313.  
  314.  
  315. Object.PercentMeter Control, Percent
  316.  
  317. Converts a Label control to a percentage meter.
  318.  
  319. Control:    Label control used as a place-holder
  320.  
  321. Percent:    The percentage to display.
  322.  
  323. Example:    mo3D.PercentMeter lblStatus, 25
  324.  
  325.  
  326.  
  327. Object.StatusBar Control, Status
  328.  
  329. Displays a message in a status bar.
  330.  
  331. Control:    Place-holder for status bar.
  332.  
  333. Status:        The message to be displayed.
  334.  
  335. Example:    mo3D.StatusBar lblStatus, "Connecting to network..."
  336.  
  337.  
  338.  
  339. Properties Summary
  340.  
  341. Object.Alignment = Alignment
  342.  
  343. Specifies the justification of the caption in a frame.
  344.  
  345. Alignment:    One of the following:
  346. gnLEFT_JUSTIFY
  347. gnRIGHT_JUSTIFY
  348. gnCENTER
  349.  
  350. Example:    mo3D.Alignment = gnLEFT_JUSTIFY
  351.  
  352.  
  353.  
  354. Object.Depth = Depth
  355. Object.Width = Width
  356.  
  357. Control the appearance of panels and borders.
  358.  
  359. Example 1:    mo3D.Width = 5
  360. Example 2:    mo3D.Depth = 2
  361.  
  362.  
  363. Object.FillColor = Color
  364. The color of the bar in the percentage meter.
  365.  
  366. Example:    mo3D.FillColor = vbBlue
  367.  
  368.  
  369.  
  370. Object.FontBold = Boolean
  371. Object.FontItalic = Boolean
  372. Object.FontName = FontName
  373. Object.FontSize = FontSize
  374. Object.FontStrikethru = Boolean
  375. Object.FontUnderline = Boolean
  376.  
  377. Specifies the font attributes for 3D text effects.
  378.  
  379. Example 1:    mo3D.FontName = cboFontNames.Text
  380. Example 2:    mo3D.FontSize = 10
  381. Example 3:    mo3D.FontBold = True
  382. Example 4:    mo3D.FontItalic = True
  383. Example 5:    mo3D.FontStrikethru = False
  384. Example 6:    mo3D.FontUnderline = False
  385.  
  386.  
  387.  
  388. Object.ForeColor = ForeColor
  389.  
  390. Specifies the color to be used for the text.
  391.  
  392. ForeColor:    Color value
  393.  
  394. Example:    mo3D.ForeColor = vbBlue
  395.  
  396.  
  397.  
  398. Object.Offset = Offset
  399.  
  400. The distance between a control and its drop shadow.
  401.  
  402. Example:    mo3D.Offset = 5
  403.  
  404.  
  405.  
  406. Object.Shadow = Shadow
  407. Specifies whether to use light or dark shadows on various 3D effects.
  408. Shadow:        One of the following:
  409.  
  410. gnLIGHT_SHADOW    Use light shadows
  411. gnDARK_SHADOW    Use dark shadows
  412.  
  413. Example:    mo3D.Shadow = gnLIGHT_SHADOW
  414.  
  415.  
  416.  
  417. Object.ShowPercent = Boolean
  418.  
  419. Specifies whether or not to show the numbers on the percentage meter.
  420.  
  421. Example:    mo3D.ShowPercent = True
  422.  
  423.  
  424.  
  425. Object.SolidMeter = Boolean
  426. Specifies whether or not to show the percentage meter as a solid bar.
  427.  
  428. Example:    mo3D.SolidMeter = True
  429.  
  430.  
  431.  
  432. Object.Style = Effect
  433.  
  434. Specifies the type of 3D effect.
  435.  
  436. Effect:    One of the following :
  437.  
  438. gnNORMAL        No 3D effect.
  439. gnRAISED        Creates a raised 3D look.
  440. gnRECESSED        Gives a recessed 3D look.
  441. gnEMBOSSED_RAISED    Gives text a raised embossed look.
  442. gnEMBOSSED_RECESSED    Gives text a recessed embossed look.
  443. gnFLOATING        Makes text look like its floating over the form.
  444. gnOUTLINE_RIGHT        Shows only the right edges of the text.
  445. gnOUTLINE_LEFT        Shows only the left edges of the text
  446. gnPROJECTED        Displays raised text from a different perspective.
  447.  
  448. Example:        mo3D.Style = gnRAISED
  449.  
  450.  
  451.  
  452. Mike Stanley
  453. 25 Lansdowne Street
  454. Manchester
  455. New Hampshire
  456. USA
  457. E-Mail: 74632.2227@compuserve.com
  458.